GetIntlResourceTable

GetIntlResourceTable
Header:	Script.h		Carbon status:	Supported

Gives you access to a specific word-selection, line-break, number-parts, untoken, or whitespace table from the appropriate international resource.

void GetIntlResourceTable (
    ScriptCode script, 
    SInt16 tableCode, 
    Handle *itlHandle, 
    SInt32 *offset, 
    SInt32 *length
);

Parameter descriptions

script: A script code, the value that specifies a particular script system. Constants for all defined script codes are listed in “Script Codes”.
tableCode: A number that specifies which table is requested. The constants for tableCode are detailed in “Table Code Constants”.
itlHandle: On return, a handle to the string-manipulation ('itl2') or tokens ('itl4') resource containing the table specified in the tableCode parameter. If the script system whose table is requested is not available, GetIntlResourceTable returns a NULL handle.
offset: On return, a pointer to the offset (in bytes) to the specified table from the beginning of the resource.
length: On return, a pointer to the size of the table (in bytes).

DISCUSSION

When you provide a script code in the script parameter, and a table code in the tableCode parameter, GetIntlResourceTable returns a handle to the string-manipulation resource or tokens resource containing that table, the offset of the specified table from the beginning of the resource, and the length of the table.

If you wish to manipulate the contents of the table you have requested, use the size returned in the length parameter to allocate a buffer, and perform a block move of the table’s contents into that buffer.

SPECIAL CONSIDERATIONS

GetIntlResourceTable may move memory; your application should not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.